home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 May / Software of the Month Club 1996 May.iso / mac / ISO9660 / ZIPFILES / FRACAN30.ZIP / FRACANIM.DOC < prev    next >
Encoding:
Text File  |  1996-02-16  |  12.0 KB  |  276 lines
  1.                     
  2.                     
  3.                    F R A C T A L   A N I M A T O R  3.0        
  4.  
  5.                   Program written by Rickard Gunnarsson 
  6.    (e95_rgu@e.kth.se, http://www2.e.kth.se/~e95_rgu/Public/fractals.html)
  7.  
  8.                   Document written by Rickard Gunnarsson
  9.                   and Daniel Sindahl (f95-dsi@nada.kth.se)
  10.  
  11. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  12. !! This program is shareware! The registration fee is SEK 200 (US$ 30,     !!
  13. !! DM 40) You may use this program for a trial period only. If you want    !!
  14. !! to continue to use the program, and want the full registered            !!
  15. !! version of the program (i.e. more than 25 frames animations and be      !!
  16. !! able to save pictures in all resolutions), you will have to register.   !!
  17. !! This unregistered version may not be used for any commercial purposes!  !!
  18. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  19.  
  20. ***************************************************************************
  21. ***************************************************************************
  22. ***************************************************************************
  23.  
  24. Introduction
  25. ------------
  26. This program is designed for creating beautiful images and animations
  27. using the mathematical phenomena called fractals. 
  28. Some features:
  29. Five different types of fractals.
  30. Powerful animation system.
  31. Four different resolutions.
  32. Save pictures and animation frames in PCX 3.0 format.
  33. Transforming between different types of fractals.
  34.  
  35. System requirements:
  36. 486DX, 4MB RAM, 800*600 graphics adaptor with 1MB graphics memory,
  37. Microsoft compatible mouse.
  38.  
  39. Recommended system:
  40. Pentium of faster, 4MB RAM, 1024*768 graphics adaptor with 1MB
  41. graphics memory, Microsoft compatible mouse, CD ROM, PAR.
  42.  
  43. ***************************************************************************
  44. ***************************************************************************
  45. ***************************************************************************
  46.  
  47. Getting started
  48. ---------------
  49. When the program is started the mainscreen will be shown. The most
  50. important button here is the 'Start!' button. Pressing 'Start!' will
  51. take you to the graphics screen, and the calculation of the fractal will
  52. begin. When the calculation is finished, several functions are
  53. available through the keyboard (see the 'Keys' section). Also, the
  54. left and right mousebuttons can be used to zoom in and out. By placing
  55. the mousepointer at the center of the area you want to enlarge, and
  56. pressing the left mousebutton you will zoom into the fractal. Pressing
  57. the right mousebutton will zoom out.
  58.  
  59. Main screen
  60. -----------
  61. On the left side of the screen are the function buttons (see the
  62. 'Buttons' section). At the bottom of the screen you will find the
  63. status/message bar. The boxes on the right side contains all
  64. essential information. The three white boxes display information
  65. concerning the animation system. The blue box in the bottom right
  66. corner displays general information, and the second blue box contains
  67. information about the current fractal. When precalculating an animation,
  68. the information in this box will display information about the current
  69. animation frame.
  70.  
  71. ***************************************************************************
  72. ***************************************************************************
  73. ***************************************************************************
  74.  
  75. Buttons
  76. -------
  77. 1. Start!
  78. Switches to the graphics screen and starts the
  79. calculation of the fractal. <ESC> key aborts the
  80. calculation. To achieve maximum speed, the <ESC>
  81. key is only checked once per row. To return to
  82. main screen, press <SPACE>.
  83.  
  84. 2. Resolution
  85. Lets you choose one of four screen resolutions.
  86.         2.1. 320*200
  87.         2.2. 640*480 (Default)
  88.         2.3. 800*600
  89.         2.4. 1024*768
  90.  
  91. 3. Fractaltype
  92. Lets you choose one of five different fractaltypes.
  93.         3.1. Mandelbrot - The classic Z^2+C Mandelbrot fractal. (Default)
  94.         3.2. Mandelbrot Z^x - A generalization  of the
  95.              normal Mandelbrot fractal. Calculates fractals
  96.              using the algorithm Z^x+C, where 0 < x < 100.
  97.         3.3. Mandelbrot Z^4 - Uses the Z^4+C algorithm.
  98.         3.4. Mandelbrot fun - My own fun version of the
  99.              Mandelbrot fractal.
  100.         3.5. Mandelbrot cos - Uses the cos(Z)+C algorithm.
  101.  
  102. 4. Precalc
  103. Estimates the calculation time of the current fractal.
  104. In addition, it displays a 160*120 preview of the
  105. fractal on the mainscreen. The estimated time can be
  106. quite different from the actual calculation time when
  107. precalculating pictures in 320*200 with very few
  108. iterations. This is because the program doesn't consider
  109. the time it takes to plot the pixels on the screen.
  110. Times > 2 minutes are very accurate.
  111.  
  112. 5. Palette change
  113. Lets you choose one of ten different palettes.
  114. The palettes are defined in the file "fracanim.cfg"
  115. If you want to use your own palettes (fractint .map format),
  116. you may modify this file. Please note that paths are not allowed.
  117.  
  118. 6. Animation
  119. This menu controls the powerful animation
  120. features of the program.
  121.         6.1. Set start    - The current fractal will be set
  122.                             as the start frame of the animation.
  123.         6.2. Set end      - The current fractal will be set
  124.                             as the end frame of the animation.
  125.                             (Note! See the 'Hints' section
  126.                             for best animation results.)
  127.         6.3. Set frames   - Sets the number of frames (1-65535,
  128.                             default: 25). In this shareware version,
  129.                             the maximum no. of frames is 25.
  130.         6.4. Set basename - Sets the basename for the animation 
  131.                             frames. Too long filenames will be
  132.                             truncated, i.e. more than 9,999 frames
  133.                             gives you only a three character basename.
  134.                             '.pcx' will be added to all filenames.
  135.         6.5. Precalc      - Estimates the calculation time of the
  136.                             animation. A small preview will also
  137.                             be shown on the mainscreen.
  138.         6.6. Start!       - Starts the calculation of the animation.
  139.                             <ESC> aborts the calculation. To return
  140.                             to mainscreen, press <SPACE>.
  141.  
  142. 7. Save PCX
  143. Save the current fractal with PCX 3.0 compression.
  144. In order to save the fractal, you will be asked to
  145. enter a filename. If no extension is entered, '.pcx'
  146. will be added to the filename. In this shareware version,
  147. you are only able to save pictures in 320*200.
  148.  
  149. 8. Change values
  150. Lets you change some important fractalparameters.
  151.         8.1. P value    - The 'x' coordinate in the
  152.                           complex plane. -2 < P < 2 (Default: 0)
  153.         8.2. Q value    - The 'y' coordinate in the
  154.                           complex plane, -2 < Q < 2 (Default: 0)
  155.         8.3. Iterations - Number of iterations.
  156.                           1 < Iterations < 1e9 (Default: 50)
  157.                           Note! A value of 1e9 can result
  158.                           in a calculation time of several
  159.                           minutes/pixel with a Pentium computer.
  160.         8.4. Zoom       - The enlargement factor. 1 < zoom < 1e14
  161.                           (Default: 1)
  162.         8.5. X value    - The exponent in the Mandelbrot Z^x algorithm.
  163.                           (Default: 1) 0 < x < 100
  164.         8.6. Change all - Lets you change all the values in the
  165.                           above order. <ESC> aborts the change
  166.                           of the current value.
  167.         8.7. Reset all  - Sets all of the above values to default.
  168.                           
  169. 9. Switch screen
  170. Displays the current fractal. To return to the main screen,
  171. press <SPACE> or left mousebutton. When displaying the fractal,
  172. all keyboard functions are enabled. See the 'Keys' section.
  173.  
  174. 10. Configuration
  175. Lets you change some additional parameters.
  176.         10.1. Zoomfactor   - The factor which the zoomvalue is
  177.                              changed by when zooming with the
  178.                              mousebuttons. (Default: 2)
  179.         10.2. Iterfactor   - The factor which the number of
  180.                              iterations is changed by when
  181.                              zooming with the mousebuttons.
  182.                              (Default: 1.2)
  183.         10.3. Sound on/off - Toggles the fractalsound on/off.
  184.                              (Default: off)
  185.                                                               
  186. 11. About
  187. Gives you information about the program and installed hardware.
  188.  
  189. 12. Quit
  190. Exits the program.
  191.  
  192. ***************************************************************************
  193. ***************************************************************************
  194. ***************************************************************************
  195.  
  196. Keys
  197. ----            
  198. While in graphics mode, the following keyboard controlled
  199. functions are available.
  200.  
  201. 0 - 9 :  Change palette
  202. f     :  Colorcycle forwards (Press 'f' or 'b' to stop)
  203. b     :  Colorcycle backwards (Press 'f' or 'b' to stop)
  204. SPACE :  Return to the mainscreen.
  205.  
  206. ***************************************************************************
  207. ***************************************************************************
  208. ***************************************************************************
  209.  
  210. The CD functions
  211. ----------------
  212. If you have a CD player installed, you can listen to music from
  213. Fractal Animator. When you are in select mode, (i.e. when the
  214. main screen is shown) these keys control the CD player:
  215.  
  216. 's'     - Start and stop the CD.
  217. '+'     - Next track.
  218. '-'     - Previous track.
  219. '0'-'9' - Select track. '0' is track 10. Tracks above 10 can be
  220.           selected with the '+' and '-' keys.
  221.  
  222. The CD device (i.e. D:, E:....) is by default set to D:. To change
  223. the device, edit the last line in the file "fracanim.cfg".
  224.  
  225. The CD functions are not very advanced, but this is a fractal program,
  226. not a CD player. The CD functions was just added because I wanted to
  227. listen to music while debugging the program.
  228.  
  229. ***************************************************************************
  230. ***************************************************************************
  231. ***************************************************************************
  232.  
  233. Hints
  234. -----
  235. 1. When creating animations: Set the endframe first, then zoom out
  236.    and set the startframe. This will give a much better result, and
  237.    prevent panning over large black areas.
  238.  
  239. 2. Precalculating an animation is really worth the time! This will
  240.    not only give you an estimated calculation time, it will also
  241.    show you if the result will be as excpected.
  242.  
  243. ***************************************************************************
  244. ***************************************************************************
  245. ***************************************************************************
  246.  
  247. Thanks to
  248. ---------
  249. Alessandra Losi for everything.
  250. Daniel Sindahl for codehints, betatesting and some documentation.
  251. Jonas Lundberg for betatesting and suggestions.
  252. Henrik Shahgholian for the cos(Z)+C documents.
  253. Peter Hanning for mathematical help and moral support.
  254. Anders Ramsay and Johan Ramsay, Elastech Computer Visions (ECV) for
  255. intropicture and suggestions.
  256. Zephyr Software for SVGA library.
  257. Edgar Swank for help with the CD functions.
  258. Peter Martin, Tobias Holmer, Niklas Wiberg, Malin Fredriksson
  259. and Jenny Unger for being great friends!
  260.  
  261. Final
  262. -----
  263. If you have any comments, suggestions or bugreports,
  264. please contact me via:
  265.  
  266.         E-mail: e95_rgu@e.kth.se
  267.         
  268.         WWW:    http://www2.e.kth.se/~e95_rgu/Public/fractals.html
  269.         
  270.         Mail:   Rickard Gunnarsson
  271.                 Vapnarvagen 13
  272.                 S-145 72 Norsborg
  273.                 Sweden
  274.  
  275. This document is not very well written. Sorry for all spelling errors.
  276.